     * 
     */
    /**
 * 
 */
/**
} 
     * 导出物业费账单
     * 发送催缴提醒
     * 分页查询物业费账单
     * 根据用户ID查询未缴费账单
     * 更新物业费信息
    // ========================= 缓存管理 =========================
     * 获取物业费收缴统计
     * 获取物业费详情
     * 获取物业费月度统计
     * 缴费
     * 批量发送催缴提醒
     * 批量生成物业费账单
     * 清除物业费相关缓存
     * 清除用户物业费缓存
     * 生成物业费账单
    // ========================= 统计分析 =========================
    // ========================= 物业费管理 =========================
 * 物业管理Service接口 - 重构版本
 * 专注于物业费管理，遵循单一职责原则
 * @author Wu.Liang
    boolean payBill(Long billId, BigDecimal paymentAmount, String paymentMethod);
    boolean sendPaymentReminder(Long billId, String remindType);
    boolean updatePropertyFee(Long billId, PropertyFeeDTO propertyFeeDTO);
import com.smart.community.commons.base.IBaseService;
import com.smart.community.commons.result.PageResult;
import com.smart.community.property.dto.BatchPropertyFeeDTO;
import com.smart.community.property.dto.PropertyFeeDTO;
import com.smart.community.property.entity.PropertyFee;
import com.smart.community.property.vo.PropertyFeeStatisticsVO;
import com.smart.community.property.vo.PropertyFeeVO;
import java.math.BigDecimal;
import java.time.LocalDate;
import java.util.List;
import java.util.Map;
    int generatePropertyBills(Long communityId, LocalDate billingMonth);
    List<PropertyFeeStatisticsVO> getMonthlyPropertyFeeStatistics(Long communityId, Integer year);
    List<PropertyFeeVO> getUnpaidBillsByUserId(Long userId);
    Map<String, Integer> batchGeneratePropertyBills(BatchPropertyFeeDTO batchDTO);
    Map<String, Integer> batchSendPaymentReminder(Long communityId, String remindType);
package com.smart.community.property.service;
    PageResult<PropertyFeeVO> pagePropertyBills(PropertyFeeDTO propertyFeeDTO);
     * @param batchDTO 批量生成参数
     * @param billId        账单ID
     * @param billId     账单ID
     * @param billId 账单ID
     * @param billingMonth 计费月份
     * @param communityId  社区ID
     * @param communityId 社区ID
     * @param paymentAmount 支付金额
     * @param paymentMethod 支付方式
     * @param propertyFeeDTO 查询条件
     * @param propertyFeeDTO 更新数据
     * @param remindType  提醒方式
     * @param remindType 提醒方式：sms-短信，email-邮件，app-APP推送
     * @param userId 用户ID
     * @param year        年份
    PropertyFeeStatisticsVO getPropertyFeeStatistics(Long communityId, Integer year);
    PropertyFeeVO getPropertyFeeDetail(Long billId);
public interface IPropertyService extends IBaseService<PropertyFee> {
     * @return 导出文件路径
     * @return 发送结果统计
     * @return 分页结果
     * @return 生成的账单数量
     * @return 生成结果统计
     * @return 是否发送成功
     * @return 是否更新成功
     * @return 是否缴费成功
     * @return 收缴统计
     * @return 未缴费账单列表
     * @return 月度统计列表
     * @return 账单详情
 * @since 2025-06-26
    String exportPropertyFeeBills(PropertyFeeDTO propertyFeeDTO);
 * @version 2.0.0
    void clearPropertyFeeCache(Long communityId);
    void clearUserPropertyFeeCache(Long userId);
